Release 10.1A: OpenEdge Development:
Messaging and ESB

createChangeStateConsumer procedure

Creates a “Change State” handle to contain the state of the SonicMQ Broker connection changes.

Syntax

PROCEDURE createChangeStateConsumer DEFINE INPUT PARAMETER procHandle AS HANDLE. DEFINE INPUT PARAMETER procName AS CHARACTER. DEFINE OUTPUT PARAMETER consumerHandle AS HANDLE.

Applies to

Session objects (ClientConnect and ServerConnect only).

Notes

Only applicable for Fault Tolerant connections.
Call the createChangeStateConsumer procedure after the beginSession procedure.
In the “Change State” handler, the character header property “state” will contain one of the following values: "active", "reconnecting", "failed", or "closed".
Setting up a change-state handler is optional. If not done, the default is to not notify the application of state changes.

See also

setFaultTolerant procedure, getFaultTolerant function, isFaultTolerant function, createChangeStateConsumer procedure, setFaultTolerantReconnectTimeout procedure, getFaultTolerantReconnectTimeout function, setInitialConnectionTimeout procedure, getInitialConnectionTimeout function, setClientTransactionBufferSize procedure, getClientTransactionBufferSize function

For more information, see the "Fault tolerance" section and the "Fault tolerance" section.